Skip to content

feat(docs): deploy previews with Alchemy Website.Nextjs - #48

Open
cooper (czxtm) wants to merge 5 commits into
mainfrom
feat/docs-website-nextjs
Open

feat(docs): deploy previews with Alchemy Website.Nextjs#48
cooper (czxtm) wants to merge 5 commits into
mainfrom
feat/docs-website-nextjs

Conversation

@czxtm

@czxtm cooper (czxtm) commented Sep 2, 2026

Copy link
Copy Markdown
Member

Summary

  • Upgrade Alchemy to 2.0.0-beta.70 and deploy docs via Cloudflare.Website.Nextjs (and web via Cloudflare.Website.Vite), dropping the wrangler pre-bundle path and the beta.57 patch.
  • Fix docs PR previews: share the docs-preview GitHub environment so new docs-pr-N environments no longer sit in action_required, skip custom hostnames the zone wildcard does not cover, capture the Alchemy URL, and smoke-check /docs/quick-start.

Test plan

  • bun install --frozen-lockfile succeeds with the updated lockfile
  • GitHub Deploy Docs workflow on this PR reaches success (not action_required)
  • Sticky PR comment includes a live preview URL
  • Preview / and /docs/quick-start return 200

Preview: https://stackpanel-docs-pr-48.drkmttr.workers.dev

Replace the wrangler pre-bundle and beta.57 patch with Cloudflare.Website.Nextjs on alchemy 2.0.0-beta.70 so OpenNext dynamic routes survive deploy. PR docs previews share the docs-preview environment, skip custom hostnames that the zone wildcard does not cover, and smoke-check /docs/quick-start.
npx next build invokes npm, which rejects this repo's catalog: protocol with EOVERRIDE and aborts the Website.Nextjs pipeline.
R2 incremental cache plus run_worker_first caused OpenNext to SSR on miss and 500 every route. Use the read-only static-assets cache and serve prerendered HTML from ASSETS first.
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Docs preview deployed to pr-48: https://stackpanel-docs-pr-48.drkmttr.workers.dev

html/body were transparent, so the article showed the browser chrome while the sidebar used bg-fd-card. Use the themed background and swap the nav logo for light/dark.
Alchemy has no 2.0.0-rc yet; latest is beta.76 and it requires effect 4.0.0-rc.112. Point Next.js deploys at @alchemy.run/frontend-frameworks and put the bun build command in open-next.config.ts.
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Preview deployed to pr-48https://pr-48.stackpanel.com

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant